Manual de Usuario
SAS-SV
Software de Auditoría de Sistemas para
San Salvador, Noviembre de 2007
Sumario de Contenido
2.1
Menú Principal
2.2
Opciones del menú de papeles de trabajo
2.2.1
Proceso
para la creación de un nuevo papel de trabajo
2.2.2
Cédulas
de auditoría de sistemas
2.2.2.1
Cédula
de planeación
2.2.2.2
Cédula
sumaria de hardware
2.2.2.3
Cédula
sumaria de software
2.2.2.4
Cédula
sumaria de políticas y procedimientos
2.2.2.5
Cédula
sumaria de seguridad
2.2.2.6
Cédula
de hallazgos
2.2.2.7
Cédula
de marcas
2.2.3
Abrir
papel
2.2.4
Cerrar
papel
2.2.5
Mis
plantillas
2.2.5.1
Proceso
para crear una nueva plantilla
2.3
Opciones
del menú de mantenimiento
2.3.1
Mantenimiento
de usuarios
2.3.2
Mantenimiento
de instituciones
2.3.3
Mantenimiento
de preguntas
2.3.3.1
Proceso
para el ingreso de preguntas
2.3.4
Copia
de seguridad
2.3.4.1
Proceso
para realizar un respaldo
2.3.4.2
Proceso
para recuperación de información
2.3.5
Estadísticas
2.4
Salida
del sistema
3
Generación
de reportes
3.1
Proceso
para generar reportes
¿ 1. INGRESO AL SISTEMA
Imagen 1: Validación de Usuario y Clave
En esta pantalla es donde el usuario
se autentica para poder ingresar al menú principal del sistema, introduciendo
su password con un máximo de tres intentos, en caso que estos sean fallidos el
usuario se bloquea automáticamente y solo el
administrador del sistema tendrá la
opción de activarlo nuevamente.
2. FUNCIONAMIENTO DEL SISTEMA
Imagen 2: Menú principal del SAS-SV
Este es el menú principal del sistema,
las opciones de este se describen de la siguiente forma:
Imagen 3: Submenú de la
opción Papeles de trabajo
En este menú del sistema es donde el
usuario podrá crear, modificar y consultar los papeles de trabajo, esta
compuesto por cuatro opciones las cuales son: crear los papeles de trabajo,
abrir papel, cerrar un papel y mis plantillas.
Imagen 4: Submenú de la
opción Mantenimiento
Este menú es donde el administrador
del sistema podrá darle mantenimiento a la
base de datos de la aplicación. Con esta opción el usuario podrá
adicionar una nueva institución, un nuevo usuario o nuevas preguntas para las
plantillas que contendrá el sistema.
Imagen 5: opción de ayuda del sistema
Esta opción de menú es el que
contendrá el manual de usuario en línea, el cual servirá para que el usuario lo
consulte en caso de tener algún inconveniente en el manejo del software.
Imagen 6: opción salida del sistema
Con
esta opción el usuario podrá salir del sistema.
2.2 OPCIONES DEL MENU
DE PAPELES DE TRABAJO
Nuevo Papel:
Imagen 7: Opciones del submenú de Papepeles de trabajo
Con esta opción de
menú el usuario creará los papeles de trabajo, eligiendo uno de los cuatro
tipos de instituciones existentes.
2.2.1 PROCESO
PARA CREACIÓN DE UN NUEVO PAPEL DE
TRABAJO
Paso 1:
Imagen 8: Pantalla de creación de nuevo
papel de trabajo
En esta pantalla es donde se elige la
entidad a la que se le va a generar un papel de trabajo, además es aquí donde
se le asigna nombre al papel de trabajo que se va a crear.
Paso 2:
Imagen 9: Pantalla de cedulas de
auditoría
En esta pantalla es
donde se le da mantenimiento a los papeles de trabajo que se han creado. Usando
las distintas cedulas de auditoría que posee el sistema, las cuales son las
siguientes: Sumaria de planeación, sumaria de hardware, sumaria software,
sumaria de políticas y procedimientos, sumaria de seguridad, sumaria de
hallazgos, marcas.
Otra funcionalidad de
esta pantalla es que al papel abierto actualmente se le puede ver/cambiar datos
y cerrar.
2.2.2 CEDULAS DE AUDITORIA DEL SISTEMA.
2.2.2.1
PLANEACION
Imagen 10: Opción de cedula de
planeación
Con la opción “Planeación” del menú
lateral izquierdo se pueden acceder a dos opciones:
Imagen 11: Opciones contenidas en la
cedula de planeación
CEDULA DE PLANEACION
Esta opción Cédula de planeación, le
permite acceder a la generación de la planificación del desarrollo de la
auditoría.
La pantalla que se presenta es la
siguiente:
Imagen 12: Ingreso de datos para la
cedula de planeación
Aquí se presentan los contenidos de la
programación, cada contenido, tiene un conjunto de procedimientos asociados y
cada procedimiento puede contener uno o más subprocedimientos.
Para ver los procedimientos de un
contenido:
Haga clic en cualquiera de los
apartados de la columna contenido y podrá ver sus procedimientos.
Para ver los subprocedimientos de un
procedimiento:
Haga clic en el procedimiento de la
tabla del cual quiere ver sus
subprocedimientos.
Para ver el contenido de la
planeación:
Cada contenido aparece numerado en un
orden secuencial, por lo que para ver la información de clic en ellos. Dicha
información aparecerá en la parte baja de la pantalla.
Para modificar un determinado
contenido, procedimiento o subprocedimiento:
Haga clic en el botón de radio
Luego haga clic en el botón
Aparecerá un formulario en el cual podrá
modificar la información del nuevo ítem
Imagen 13: Pantalla para modificar datos
en la cedula de planeación
Una
vez modificado el nuevo dato, haga clic en el botón Modificar
Para
eliminar un determinado contenido, procedimiento o subprocedimiento:
Haga
clic en el botón de radio
Luego
haga clic en el botón
Conteste
que sí al cuadro de confirmación que aparecerá
Imagen 14: Pantalla de confirmación de
eliminación de datos en la cedula de
planeación
Para
insertar un nuevo contenido,
procedimiento o subprocedimiento
Seleccione
el botón de radio
Haga
clic en el botón
Aparecerá
un formulario en el cual podrá insertar la información del nuevo ítem
Imagen 15: Pantalla para insertar
información en la cedula de planeación
Una
vez agregado el nuevo dato, haga clic en el botón Grabar .
Al
final de la pantalla se encuentran dos botones:
Construye
una versión imprimible del documento de planeación.
Envía
la planeación por correo al administrador.
NOTA DE REQUERIMENTOS
La opción Nota de Requerimientos, le
permite mantener una ficha de datos con los requerimientos solicitados por el
auditor previa realización de la auditoría o en el desarrollo de la auditoria.
Imagen 16: Pantalla de ingreso de datos
para la nota de requerimientos
En la tabla de contenido aparecen
sucesivamente los datos de:
Requerimiento: El nombre del recurso
que se solicita.
Breve descripción del requerimiento.
El nombre de la persona que lo entrega
La fecha en que se recibió.
La columna de Marcas que es la última
del formulario contiene un símbolo indicando si el requerimiento ha sido “entregado” o “no entregado”.
Para modificar el dato de un
requerimiento específico:
Haga clic en el botón de radio
Luego haga clic en el botón
Aparecerá un formulario en el cual
podrá modificar la información del nuevo ítem como se muestra en la siguiente
figura:
Imagen 17: Pantalla para modificar datos
en la nota de requerimientos
Una vez modificado el nuevo dato, haga
clic en el botón Modificar
Para eliminar un determinado
requerimiento:
Haga clic en el botón de radio
Luego haga clic en el botón
Conteste que sí al cuadro de
confirmación que aparecerá
Imagen 18: pantalla de confirmación de
eliminación de datos de la nota de requerimientos
Para insertar un nuevo requerimiento:
Dar clic en el botón en caso que el formulario no tenga
información, es decir no tiene ningún requerimiento, caso contrario seleccione
el botón de radio
Al dar clic en el botón , aparecerá un formulario como el que se
muestra en la siguiente figura para ingresar la información del nuevo ítem.
Imagen
19: Pantalla para insertar información de la nota de requerimientos
Una vez agregado el nuevo dato, haga
clic en el botón Grabar
Al final de la pantalla aparece el
botón . Al hacer clic en él,
se construye una versión imprimible de la nota de requerimientos.
2.2.2.2
CEDULA
SUMARIA DE HARDWARE
La funcionalidad de
esta cedula es evaluar los aspectos relacionados con los equipos informáticos
que posee cada entidad fiscalizada.
Imagen 20: Cedula sumaria de hardware
2.2.2.3
CEDULA
SUMARIA DE SOFTWARE
Con esta cedula se
van evaluar los aspectos relacionados con todo el software instalado en las
estaciones de trabajo que posee cada entidad fiscalizada.
Imagen 21: Cedula sumaria de software
2.2.2.4
CEDULA
SUMARIA DE POLITICAS Y PROCEDIMIENTOS
Con esta cedula se va
a evaluar la documentación referente a los diversos procesos que utiliza cada
entidad fiscalizada para la operatividad de los sistemas y su cumplimiento.
Imagen 22: Cedula sumaria de políticas y
procedimientos
2.2.2.5
CEDULA
SUMARIA DE SEGURIDAD
Con esta cedula se va
a evaluar los aspectos realcionados con los estandares de seguridad
implementados por cada entidad fiscalizada.
Imagen 23: Cedula sumaria de seguridad
2.2.2.6 CEDULA DE
HALLAZGOS
Esta cedula es la que
contendrá los reportes emitidos por el software desarrollado, en el literal
número tres del presente documento se detalla cada uno de estos reportes.
Imagen 24: Cedula de Hallazgos
2.2.2.7 CEDULA DE
MARCAS
En esta cédula se
hace referencia de toda la simbología utilizada en el software. Se ingresa a
esta cédula haciendo clic al botón que se muestra en la figura 25.
Imagen 25: Cédula de marcas
2.2.3 ABRIR PAPEL
Imagen 25: Pantalla para abrir un papel de trabajo
Esta opción sirve
para abrir un papel de trabajo existente, es decir que al seleccionar esta
opción, el usuario podrá consultar cualquier papel de trabajo.
2.2.4 CERRAR PAPEL
Con esta opción el
usuario podrá salirse del papel de trabajo en el que esté trabajando.
Imagen 26: Opción para cerrar un papel de trabajo
2.2.5 MIS PLANTILLAS
Imagen 27:
Pantalla para consultar plantillas de preguntas
Esta opción es la que
sirve para elegir las preguntas que contendrá el programa de auditoria a
desarrollar.
2.2.5.1 PROCESO PARA CREAR UNA NUEVA PLANTILLA
PASO 1:
Imagen 28: Pantalla
para creación de plantillas de preguntas
Se le da clic a la
opción “Mis plantillas” y se entra a
la pantalla que se muestra en la figura anterior que se llama “Plantillas del usuario”, en esta
pantalla se pueden ver las plantillas creadas por el usuario actual.
Para crear una nueva
plantilla el usuario da un clic a la opción “Crear una nueva plantilla” y
luego seleccionará las preguntas que contendrá la nueva plantilla.
PASO 2:
Imagen 29: Pantalla
para almacenar una nueva plantilla
Habiendo entrado a la
pantalla “crear nueva plantilla” , se
eligen las preguntas que va a contener la plantilla, para ello se le da clic en
la casilla que aparece en la parte de derecha de cada pregunta, es decir en la
columna con nombre “seleccionada”.
Despues de haber
elegido las preguntas se le da clic a la opción gravar plantilla para que
esta quede almacenada en la base de datos.
2.3 OPCIONES DEL MENU
DE MANTENIMIENTO
2.3.1 MANTENIMIENTO DE
USUARIOS
Imagen 30: Submenú de
la opción de Mantenimiento
Imagen 31: Pantalla
para crear un nuevo usuario al SAS - SV
Esta opción de menú
sirve para crear los usuarios del sistema, opción que solamente estará activa
para el administrador del sistema.
2.3.2 MANTENIMIENTO DE
INSTITUCIONES
Imagen 32: Submenú de la opción
Mantenimiento
Imagen 33: Pantalla para crear una nueva
institución en el SAS - SV
Con esta opción del menú se ingresan
los datos generales de las entidades que estarán registradas en el sistema.
2.3.3 MANTENIMIENTO DE PREGUNTAS
Imagen 34: Submenú de la opción
Mantenimiento
Para adicionar nuevas preguntas a los
programas de auditoria el administrador del sistema deberá ingresar al menú de
“mantenimiento”, luego debe elegir
la opción “Preguntas”,
inmediatamente el sistema mostrará la pantalla que se muestra en la siguiente
figura.
Imagen 35: Pantalla para una nueva pregunta al SAS -
SV
En esta pantalla el administrador del
sistema podrá verificar todas las preguntas que contiene el sistema, luego para
adicionar una nueva se le debe dar clic a la opción de “agregar una pregunta nueva”.
2.3.3.1 PROCESO PARA EL INGRESO DE PREGUNTAS
Imagen 36:
Pantalla para editar el texto de la nueva pregunta
En esta pantalla el administrador del
sistema podrá ingresar el texto de la nueva pregunta a registrar, para ello se
deberá seguir los siguientes pasos:
PASO
1: En el cuadro “Texto de la pregunta”, digite el enunciado que contendrá la pregunta
a ingresar.
PASO
2: En la opción “Cedula a la que pertenece”, seleccione el nombre de la cedula a la
que pertenecerá la pregunta digitada.
PASO
3: En la opción “entidades a la que aplica”, seleccione
la entidad a la que aplica la pregunta que se desea ingresar.
PASO
4: Después de haber
realizado los pasos 1,2 y 3 se da clic en la opción “Agregar pregunta” para guardar la información digitada, luego el
sistema mostrará un mensaje de confirmación el cual le indica al usuario que la
pregunta ha sido agregada.
2.3.4 COPIA DE SEGURIDAD
Con esta opción se podrán realizar
respaldos de la base de datos y recuperación de información, para ello en el
menú principal se selecciona del menú de mantenimiento la opción “COPIA DE
SEGURIDAD”, luego el sistema mostrará la pantalla que aparece en la siguiente figura.
Imagen 37: Pantalla para hacer una Copia de Seguridad
En esta pantalla el usuario tendrá la
opción de realizar un respaldo de la base de datos o recuperar la información
de un respaldo ya efectuado.
2.3.4.1 PROCESO PARA REALIZAR UN RESPALDO
PASO
1: Cree un archivo
nuevo de texto en la zona de la computadora donde desea el respaldo.
PASO
2: De clic en el
botón examinar del cuadro archivo de respaldo.
PASO
3: Seleccione el
archivo creado en el paso 1.
PASO
4: De clic en el
botón respaldar. Luego aparecerá un mensaje de confirmando la finalización del
respaldo.
2.3.4.2 PROCESO PARA RECUPERACIÓN DE INFORMACIÓN
PASO
1: De clic en el
botón examinar del cuadro archivo de recuperación.
PASO
2: Seleccione el
archivo que contiene el respaldo de la base de datos.
PASO
3: De clic en el
botón recuperar y luego aparecerá un mensaje de proceso de recuperación, al
finalizar dicho proceso aparecerá otro mensaje confirmando la finalización de
la recuperación de información.
2.3.5 ESTADÍSTICAS
En este menú el administrador del
sistema podrá obtener datos estadísticos que le ayudaran en la toma de
decisiones referente al desempeño de los auditores y al trabajo realizado a las
diversas entidades.
Imagen 38:
Pantalla para Consulta de Estadísticas
Imagen 39:
Pantalla para mostrar grafico de Estadísticas
2.4 SALIDA DE SISTEMA
Con
esta opción del menú el usuario podrá
salirse completamente del sistema.
Imagen 40: Pantalla de confirmación de
salida del sistema
3. GENERACIÓN DE REPORTES
Los reportes que el sistema va a
generar son los siguientes: Acta de resultados de auditoría, informe de
hallazgos y nota de resultados de auditoria.
3.1
PROCESO
PARA GENERAR LOS REPORTES DEL SISTEMA.
Dando clic en la opción de HALLAZGOS aparecerá
en la pantalla principal un cuadro como se muestra en la figura 41, donde se
pueden modificar diversos aspectos específicos de cada uno de los reportes
siendo estos los siguientes:
Encabezado
del acta de auditoría
Firmantes
del acta
Elaborador
del informe
Revisor
del informe
Encabezado
de la nota de hallazgos
Asunto
de la nota de hallazgos
Introducción
de la nota de hallazgos
Conclusión
de la nota
Pie
de la nota
Para
modificar cualquiera de estos aspectos, haga clic en el botón ubicado al lado derecho
de cada uno de ellos.
Imagen 41: Pantalla de cedula de
hallazgos
Imagen 42: Pantalla de campos contenidos
en la nota e informe de hallazgos
Después de dar clic al botón a la
derecha de cada opción, aparecerá un formulario como se muestra en la figura
40, en el cual se podrá modificar la información respectiva.
Imagen 43: Pantalla para editar los
reportes del sistema SAS-SV
El
botón “Poner contenido ejemplo”, carga en el área de edición un texto que puede
servir como guía para escribir la información del campo.
Una
vez editada la información, haga clic en el botón “Grabar”, para guardar los
cambios.
Luego de rellenar cada uno de estos
campos, se procede a construir la información de contenido de los reportes,
esto se hace mediante la tabla que aparece a continuación, la cual reúne todos
aquellos aspectos que fueron catalogados con respuestas “no cumple” o
“incompleto” en los papeles de auditoría.
Imagen 44: Pantalla para generar el
contenido de los reportes del sistema SAS-SV
Los
campos de contenido a editar son los siguientes:
Área
auditada: Identificación
del área a la que corresponden los hallazgos encontrados.
Criterio: Base legal que
se está incumpliendo.
Causa: Motivo por lo
que se ha dado el hallazgo.
Efecto:
Consecuencias que trae el incumplimiento del hallazgo encontrado y
recomendaciones del auditor.
Comentario: observación
del personal con el que se está discutiendo el acta.
Se puede seleccionar si un aspecto (de
los calificados como incompletos) aparecerá en el acta de auditoría o no,
seleccionando la opción “Incluir en el acta”. Los aspectos catalogados como “no
cumple” aparecerán obligatoriamente.
Una vez editada esta información sólo
queda generar los reportes, para ello se tienen cuatro botones en la parte
inferior:
Imagen 45: Pantalla para generar los reportes del sistema SAS-SV
Los tres primeros botones generan el
Acta de Auditoría, el Informe de Hallazgos y
Manual de Mantenimiento
Software
de Auditoría de Sistemas para
San Salvador, Noviembre de 2007
SUMARIO DE CONTENIDO
Diagrama
general de directorios
Matrices
de contenidos
Directorio clases
Directorio estilos
Directorio imágenes
Directorio páginas
Directorio raíz.
Directorio respaldos
Directorio scripts
1. INTRODUCCIÓN
El presente manual tiene
por objetivo ilustrar a las personas que deseen conocer detalles del
funcionamiento interno del software SAS-SV. Esta información puede servir al
programador, web master o administrador, como apoyo al llevar a cabo una
actualización del sistema a nivel de código o para llevar un registro de los
archivos del sitio que facilite su posterior mantenimiento.
2. ESTRUCTURA DEL SOFTWARE COMO SITIO WEB
En este apartado se
describirá el software, tomándolo como una aplicación de Internet, la cual, al
igual que cualquier sitio para
2.1
Diagrama General de Directorios
La estructura de
directorios que compone en general al sitio Web se detalla como sigue:
SCRIPTS JSCALENDAR SASS ESTILOS IMAGENES DOCUMENTACIÓN CLASES PAGINAS MANTENIMIENTO GRAFICOS TABLAS PAPELES PHPMAILER
Imagen 1: Estructura de archivos de la aplicación web
2.2 Matrices de Contenidos
Las tablas que a
continuación se muestran, llamadas también “matrices de contenido”, listan y
describen cada uno de los archivos del sitio. Se presentan directorio por
directorio según la estructura vista en el apartado 3.1 de este manual.
Directorio
Raíz
|
Nombre
del archivo |
Descripción |
Tipo
de archivo |
Formato |
|
index.php |
Página cuyo fin es redireccionar a
la página de entrada al sistema autenticación.php |
Texto |
PHP |
|
menu.php |
Contiene la función que construye y
personaliza la línea principal de menú, dependiendo de la página de la
aplicación donde el usuario se encuentre en un determinado momento. |
Texto |
PHP |
Directorio
Clases
|
Nombre
del archivo |
Descripción |
Tipo
de archivo |
Formato |
|
clases.php |
Archivo que contiene la definición
de todas las clases PHP que se han instanciado en las páginas del sitio. |
Texto |
PHP |
Directorio
Documentación
|
Nombre
del archivo |
Descripción |
Tipo
de archivo |
Formato |
|
manualUsuario.php |
El manual de usuario del sistema. |
Texto |
PHP |
|
manualMantenimiento.php |
El manual de mantenimiento del
sistema. |
Texto |
PHP |
|
manualInstalacion |
El manual de instalación del
sistema. |
Texto |
PHP |
Directorio
Estilos
|
Nombre
del archivo |
Descripción |
Tipo
de archivo |
Formato |
|
estilos.css |
Hoja de estilos que se incluye y
aplica en las páginas de la aplicación visibles al usuario. |
Texto |
CSS |
Directorio
Imágenes
|
Nombre
del archivo |
Descripción |
Tipo
de archivo |
Formato |
|
boton1.jpg |
Botón de salida de la aplicación,
ubicado en el menú principal |
Imagen |
JPG |
|
boton2.jpg |
Botón para el trabajo con papeles de
auditoría, ubicado en el menú principal. |
Imagen |
JPG |
|
boton3.jpg |
Botón para el acceso a las páginas
de mantenimiento. Sólo visible en el rol de administrador y ubicado en el
menú principal. |
Imagen |
JPG |
|
botonCambios.jpg |
Botón para acceder a la opción de
renombrar el papel de trabajo actual o modificar su descripción. Ubicado en
el menú lateral izquierdo para trabajo con papeles de auditoría. |
Imagen |
JPG |
|
botonCerrar.jpg |
Botón para cerrar el papel de
trabajo actual y permitir a la aplicación abrir otro. Ubicado en el menú
lateral izquierdo para trabajo con papeles de auditoría. |
Imagen |
JPG |
|
botonHallazgos.jpg |
Botón para acceder a la
funcionalidad de generación de reportes. Ubicado en el menú lateral izquierdo
para trabajo con papeles de auditoría. |
Imagen |
JPG |
|
botonHardware.jpg |
Botón para acceder a las preguntas
de auditoría en el papel actual, correspondientes a la cédula de hardware.
Ubicado en el menú lateral izquierdo para trabajo con papeles de auditoría. |
Imagen |
JPG |
|
botonMarcas.jpg |
Botón para acceder a la cédula de
marcas del papel actual. Ubicado en el menú lateral izquierdo para trabajo
con papeles de auditoría. |
Imagen |
JPG |
|
botonPlaneacion.jpg |
Botón para acceder a las preguntas
de auditoría en el papel actual, correspondientes a la cédula de planeación.
Ubicado en el menú lateral izquierdo para trabajo con papeles de auditoría. |
Imagen |
JPG |
|
botonPlaneación.jpg |
Botón para acceder a las preguntas
de auditoría en el papel actual, correspondientes a la cédula de planeación.
Ubicado en el menú lateral izquierdo para trabajo con papeles de auditoría. |
Imagen |
JPG |
|
botonPoliticas.jpg |
Botón para acceder a las preguntas
de auditoría en el papel actual, correspondientes a la cédula de políticas y
procedimientos. Ubicado en el menú lateral izquierdo para trabajo con papeles
de auditoría. |
Imagen |
JPG |
|
botonSeguridad.jpg |
Botón para acceder a las preguntas
de auditoría en el papel actual, correspondientes a la cédula de seguridad.
Ubicado en el menú lateral izquierdo para trabajo con papeles de auditoría. |
Imagen |
JPG |
|
botonSofware.jpg |
Botón para acceder a las preguntas
de auditoría en el papel actual, correspondientes a la cédula de sofware.
Ubicado en el menú lateral izquierdo para trabajo con papeles de auditoría. |
Imagen |
JPG |
|
encabezado2.jpg |
Logo del sistema. Ubicado en la
parte central superior de cada una de las páginas del sitio. |
Imagen |
JPG |
|
iconoContactos.jpg |
Icono que señala la opción de acceso
al mantenimiento de contactos de una institución. Sólo visible para el rol de
administrador. |
Imagen |
JPG |
|
iconoModificar.jpg |
Icono que señala la opción de acceso
a la modificación de datos en los mantenimientos de usuario, instituciones o
contactos.. Sólo visible para el rol de administrador. |
Imagen |
JPG |
|
iconoPapelera.jpg |
Icono que señala la opción de acceso
al borrado de datos para un usuario o
contacto Sólo visible para el rol de administrador. |
Imagen |
JPG |
|
logoSuper.jpg |
Imagen representativa de |
Imagen |
JPG |
|
logoUDB.jpg |
Imagen representativa de |
Imagen |
JPG |
Directorio
Scripts
|
Nombre
del archivo |
Descripción |
Tipo
de archivo |
Formato |
|
scripts.js |
Archivo de funciones JavaScript
utilizadas en la mayoría de páginas del sitio. Las funciones incluidas en él
están ordenadas alfabéticamente. |
Texto |
JS |
Directorio
jsCalendar
Este directorio no es nativo del
software que ocupa este manual. Es una librería JavaScript de libre
distribución, diseñada para construir calendarios dinámicos. En el software
SAS-SV se hace referencia a ella en la página bitacoraUsuario.php para desplegar un calendario que sirva para
elegir la fecha de la cual se quiere ver la bitácora. Esta librería fue
descargada en su última versión de la dirección: http://www.dynarch.com/projects/calendar/.
En este sitio se puede además encontrar la documentación referente a este
directorio.
Directorio
phpMailer
En este directorio se encuentra el
archivo class.phpmailer.php que contiene una clase espacial para el manejo del
correo electrónico. Este archivo no pertenece propiamente al software, sino que
se ha descargado externamente del sitio http://phpmailer.sourceforge.net
donde se encuentra la documentación del archivo.
3. MANEJO DE SESIONES
El enlace de las páginas del sitio no
se hace únicamente mediante vínculos HTML. Esto debido a que es necesario
mantener determinada información: nombre del usuario y su rol, papel e
institución actual así como también el nombre de la plantilla de preguntas y el
tipo de menú principal que se despliega dependiendo del rol del usuario. En el
software SAS-SV se ha optado por incluir estos datos una sola vez en una página
(específicamente en la página menuPrincipal.php
del directorio paginas) y
referenciarlos varias veces en las demás páginas. Esto se logra aplicando el
concepto de sesiones, el cual es un mecanismo que provee el lenguaje PHP
para agrupar un grupo de páginas web dinámicas de un mismo sitio en una sola
aplicación con variables comunes. Además, las sesiones son útiles para evitar
la entrada de usuarios a la aplicación sin antes pasar por el proceso de
autenticación.
La tabla siguiente describe cada una
de las variables de sesión que se utilizan en el sitio:
|
Nombre
de la variable |
Descripción |
|
$modoSesion |
Esta variable puede contener dos
valores: El 1 indica que el software está funcionando en usuario de
“emergencia”, que sólo permite añadir un usuario administrador, si es que no
está añadido ya uno. El valor 2 indica que se está usando como usuario
“administrador”, “consulta” u “operador”. |
|
$rolSesion |
Esta variable contiene una cadena
que representa el rol del usuario que está usando el sistema actualmente. Sus
valores pueden ser “Administrador”,
“Operador” o “Consulta”. |
|
$usuarioSesion |
Contiene el nombre de usuario de la
persona que ocupa el software. Dicho nombre también es conocido como su login. |
|
$idMenu |
Esta variable almacena un entero que
identifica el tipo de menú que se construirá dinámicamente, dependiendo del
rol del usuario actual. Un valor de 1 hará un menú para administrador, un 2
para operador, un 3 para consulta y un 4 para emergencia. |
|
$tipoEntidadSesion |
Contiene un número identificador del
tipo de institución a la cual se le está trabajando un papel de auditoría.
Este número es 0 para almacenes, 1 para Bolsa de Valores, 2 para una casa
corredora y 3 para CEDEVAL. |
|
$nombrePlantillaSesion |
Contiene el nombre de la plantilla
de preguntas personalizada que se está aplicando a las cédulas del papel
actual. |
|
$nombrePapelSesion |
Contiene el nombre dado por el
usuario al papel actual. |
|
$nombreEntidadSesion |
Contiene el nombre de la institución
a la cual se le está trabajando un papel de auditoría. |
|
$nsesion |
Número identificador de la sesión
PHP para mantener todas las páginas del sitio con variables comunes. |
|
$isesion |
Nombre identificador de la sesión
PHP para mantener todas las páginas del sitio con variables comunes. |
|
$entrada |
Variable que determina si se ha
entrado al sistema por medio de la página de autenticación. |
4. MANEJO DE ENVIO DE DATOS
POST
En la aplicación, por motivos de
seguridad, se prefiere usar el envío de datos POST al GET cuando es necesario.
Dicho envío se realiza por una de las dos formas siguientes:
La primera es por medio de formularios ocultos, los cuales se
colocan al principio de la página que se ocupan. Estos formularios contienen
campos tipo “hidden”, y se envían con método POST. Para disparar su evento submit, se hace uso de funciones JavaScript
que se nombran enviarFormularioX
donde X es un número que identifica a la función. Una de estas funciones
típicas se define como sigue:
function
enviarFormularioX(valor1,valor2){
// Se coloca el valor de los campos hidden
que se enviarán:
document.frmOculto1.campoHidden1.value =
valor1;
document.frmOculto1.campoHidden2.value =
valor2;
// Poner el valor de otros campos hidden
// Se envía el formulario vía POST:
document.frmOculto1.submit();
}
Todas las funciones de envío de
formularios ocultos se listan en el archivo scripts.js
de la carpeta scripts.
La segunda forma es ocupando envío de datos asíncrono. Esto se logra por medio del objeto
JavaScript XMLHttpRequest, incluido en la mayoría de navegadores populares de
la actualidad. Para ejemplos de su uso y comentarios específicos, revisar el
código de las funciones objetoAjax y autenticar2 en el archivo scripts.js
de la carpeta scripts.
5. DOCUMENTACIÓN INTERNA
Tanto en los archivos de JavaScript
como en los de PHP, se comenta el código profusamente. Las líneas de
comentarios se distinguen por comenzar con // para una sola línea, o encerradas
entre /* y */
para varias líneas. Para distinguir mejor el código, se sugiere el
empleo de algún editor especializado con cromado de código como el ConText, que
se ocupó para el desarrollo de este software, o el OmegaEdit.
Manual de Instalación
Software
de Auditoría de Sistemas para
San Salvador, Noviembre de 2007
SUMARIO DE CONTENIDO
1. INTRODUCCIÓN
En el presente manual se describen los
pasos que el usuario debe realizar para instalar por primera vez en su estación
de trabajo el sistema SAS-SV (Software de auditoría de sistemas para
2. REQUISITOS DEL SISTEMA
El sistema puede usarse en una sola
máquina que funja como servidor y cliente al mismo tiempo, o con una máquina
servidora y varias computadoras clientes. La tabla siguiente muestra los
requisitos mínimos de ambos tipos de máquina antes de la instalación del
software, la cual sólo se lleva a cabo en la computadora servidora.
|
Tipo de requisito |
Tipo de Máquina |
|
|
Servidor |
Cliente |
|
|
Hardware |
300 megabytes mínimos de espacio
libre en disco duro de la máquina servidora, para la instalación de los
servidores y de la base de datos. |
Conexión de red local, con acceso a
la computadora servidora. |
|
|
Procesador Pentium |
Procesador Pentium |
|
|
24 MB de RAM |
16 MB de RAM |
|
|
Conexión de red local con las
computadoras cliente. |
|
|
Software |
Servidor Web Apache 5.0 |
Sistema
Operativo Windows 9x,Me, NT, 2000, XP, o Windows Server 2003. |
|
Intérprete de lenguaje PHP versión 5 |
Soporte de protocolo de comunicación
TCP/IP |
|
|
Servidor de Base de Datos MySQL 5.0 |
Navegador de Internet (Explorer 5,
Firefox 1.0.7, Netscape 8.1.3 u Opera
9.21) |
|
|
Sistema
Operativo Windows 9x,Me, NT, 2000, XP, o Windows Server 2003. |
|
|
|
Soporte de protocolo de comunicación
TCP/IP |
|
|
|
Navegador de Internet (Explorer 5,
Firefox 1.0.7, Netscape 8.1.3 u Opera
9.21) |
|
|
3. PROCESO DE INSTALACIÓN
El software se instala una sola vez en
la máquina destinada como servidor. Una vez hecho esto, las máquinas clientes
(que están conectadas en red al servidor), podrán usar el software, digitando
en su navegador de Internet:
http://direccion ip del servidor/sassv
Un ejemplo es: http://4.8.15.2/sassv
En donde, en el ejemplo, la dirección
ip de red del servidor es 4.8.15.2
Para instalar el software en el
servidor, siga los siguientes pasos (se presuponen existentes en el servidor
los requisitos software mencionados en el apartado 2 de este manual) :
1)
Localice
en la computadora servidor, la carpeta raíz de su Web (la localización de ésta
variará dependiendo de cómo haya instalado su servidor Web).
2)
Copie
la carpeta SASSV del CD-ROM del software a dicha carpeta raíz.
3)
Localice
en la computadora servidor, la carpeta bin de su servidor de base de datos
MySQL (la localización de ésta variará
dependiendo de cómo haya instalado su servidor Web, aunque generalmente suele
instalarse en la misma carpeta padre del servidor Web).
4)
Copie
el archivo guion.sql del CD-ROM del programa, a la carpeta bin encontrada
anteriormente.
5)
Entre
al programa cliente mysql de su servidor de base de datos. Para ello puede
utilizar la consola MS-DOS de Windows. Para correr dicho programa deberá
ubicarse en el directorio bin de la carpeta MySQL. Ingrese al mismo utilizando
un nombre de usuario y contraseñas válidas. Todo lo anterior, dependerá de cómo
se haya instalado el servidor MySQL. Aquí hay un ejemplo específico para una
máquina, el cual no necesariamente debe ser su caso:
Imagen 1: Pantalla de ingreso al programa cliente mysql
6) Una vez adentro, cree la base de datos
bdsas:
Imagen 2: Pantalla de creación de la base de datos bdsas
7) Salga del cliente mysql:
Imagen 3: Pantalla de salida del cliente mysql
8)
Vuelva
a entrar; pero esta vez, utilizando la base creada y llamando el archivo
guion.sql copiado en el paso 2. La siguiente figura, muestra como hacerlo.
Imagen 4: Pantalla de ingreso a la base de datos cargando el archivo
guion.sql
9)
Abra
el archivo clases.php de la carpeta clases del directorio sassv que copió en el
paso 2.
10) La línea 13 se lee así:
function
Conexion($user="rpineda",$wordkey="rpineda",$serv="localhost",$base="bdsas")
modifique dicha línea para que incluya
el nombre de su servidor web, así como el login y password de su servidor de
base de datos MySQL. Consulte la documentación de su servidor web para
encontrar estos datos. Por ejemplo, si la dirección de su servidor web es 4.8.15.7, el usuario de la base de
datos es userdb y el password es passdb, la línea quedaría así:
function
Conexion($user="userdb",$wordkey="passdb",$serv="4.8.15.7",$base="bdsas")
Una vez hecho lo anterior, podrá
ingresar al sistema, desde cualquier explorador Web utilizando la siguiente
dirección:
http:// dirección ip de la máquina
servidor/sassv
Si la misma computadora servidora
sirve como cliente (no será así generalmente), la dirección ip será 127.0.0.1 ó
localhost.
11) Posteriormente, deberá registrarse un usuario
administrador. Para ello, ingrese al sistema desde su navegador web, de la
forma explicada anteriormente:
Imagen 5: Pantalla de validación de Usuario y Clave
12) Una vez en esta pantalla ingrese utilizando
los datos
Login: sa
Password: sap
Imagen 6: Pantalla de ingreso de
Usuario y Clave
13) Escoja el menú mantenimiento y luego la opción
usuarios
Imagen 7: Pantalla de ingreso al mantenimiento de usuarios del sistema
14) Haga
clic en Agregar un nuevo usuario
Imagen 8: Pantalla de mantenimiento
de usuarios
15) Llene
el formulario con los datos del administrador y haga clic en ingresar
usuario.
Imagen 9: Pantalla para adicionar
un nuevo usuario del sistema
Luego de haber llenado el formulario aparecerá
un mensaje de confirmación del ingreso.
Una vez hecho esto, puede comenzar a
utilizarse el sistema. El administrador podrá registrar roles de usuario y de
consulta y éstos podrán utilizarlo según los privilegios que su rol les
proporcione.
Para mayor explicación sobre el uso
del sistema, consulte el manual de
usuario de sas-sv.
4. ACERCA DEL CD DE
El CD que acompaña este trabajo
contiene dos carpetas:
El directorio sassv incluye el software propiamente dicho. Esta carpeta a la que
se refiere el paso 2 del apartado proceso
de instalación. Aquí también se incluye una carpeta con la documentación
(manuales de usuario, mantenimiento e instalación).
El directorio trabajo incluye el
trabajo escrito en el cual se apoya el diseño y desarrollo de la aplicación.